Skip to main content

Handle Offline Playback

Feed is required by its rights holders to report all plays from end users, including plays that occur when the device has no internet connection. Your app must account for this scenario.

There are two supported approaches:

Allow the user to continue playing content while offline. When the device regains connectivity, send the play event with an accurate back-dated timestamp reflecting when the play actually occurred.

Call the Report Clip Play endpoint (POST /v2/clips/{id}/play) with the offline parameter set and the original play timestamp. In v1 this was POST /play with offline: true.

This option is recommended because it preserves the user experience. It requires that:

  • The clip audio is already present on the device.
  • Your app can record play events with accurate timestamps while offline.
  • Your app will reliably send those queued events once the device reconnects.

If all three conditions are met, implement Option 1.

Option 2: Prevent Playback When the Play Call Fails​

If your app cannot guarantee queued offline reporting, prevent playback from starting whenever the play call fails due to a network error. Show the user an appropriate message and wait until connectivity is restored before allowing playback to resume.

This is a safe fallback for apps that cannot reliably queue and replay events.